home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_findutils.idb / usr / freeware / catman / u_man / cat1 / xargs.Z / xargs
Encoding:
Text File  |  1998-05-21  |  6.4 KB  |  200 lines
  1. /xlv1/freeware/1998.May/findutils/4.1/findutils-4.1.diffbuild/xargs
  2.  
  3.  
  4.  
  5.      XXXXAAAARRRRGGGGSSSS((((1111LLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXAAAARRRRGGGGSSSS((((1111LLLL))))
  6.  
  7.  
  8.  
  9.      NNNNAAAAMMMMEEEE
  10.       xargs    - build    and execute command lines from standard    input
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.       xxxxaaaarrrrggggssss    [-0prtx] [-e[eof-str]] [-i[replace-str]] [-l[max-
  14.       lines]] [-n max-args]    [-s max-chars] [-P max-procs] [--null]
  15.       [--eof[=eof-str]] [--replace[=replace-str]] [--max-
  16.       lines[=max-lines]] [--interactive] [--max-chars=max-chars]
  17.       [--verbose] [--exit] [--max-procs=max-procs] [--max-
  18.       args=max-args] [--no-run-if-empty] [--version] [--help]
  19.       [command [initial-arguments]]
  20.  
  21.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.       This manual page documents the GNU version of    xxxxaaaarrrrggggssss.    xxxxaaaarrrrggggssss
  23.       reads    arguments from the standard input, delimited by    blanks
  24.       (which can be    protected with double or single    quotes or a
  25.       backslash) or    newlines, and executes the _c_o_m_m_a_n_d (default is
  26.       /bin/echo) one or more times with any    _i_n_i_t_i_a_l-_a_r_g_u_m_e_n_t_s
  27.       followed by arguments    read from standard input.  Blank lines
  28.       on the standard input    are ignored.
  29.  
  30.       xxxxaaaarrrrggggssss    exits with the following status:
  31.       0 if it succeeds
  32.       123 if any invocation    of the command exited with status 1-125
  33.       124 if the command exited with status    255
  34.       125 if the command is    killed by a signal
  35.       126 if the command cannot be run
  36.       127 if the command is    not found
  37.       1 if some other error    occurred.
  38.  
  39.     OOOOPPPPTTTTIIIIOOOONNNNSSSS
  40.       --_n_u_l_l, -_0
  41.            Input filenames are terminated by a null    character
  42.            instead of by whitespace, and the quotes    and backslash
  43.            are not special (every character    is taken literally).
  44.            Disables    the end    of file    string,    which is treated like
  45.            any other argument.  Useful when    arguments might
  46.            contain white space, quote marks, or backslashes.  The
  47.            GNU find    -print0    option produces    input suitable for
  48.            this mode.
  49.  
  50.       --_e_o_f[=_e_o_f-_s_t_r], -_e[_e_o_f-_s_t_r]
  51.            Set the end of file string to _e_o_f-_s_t_r.  If the end of
  52.            file string occurs as a line of input, the rest of the
  53.            input is    ignored.  If _e_o_f-_s_t_r is    omitted, there is no
  54.            end of file string.  If this option is not given, the
  55.            end of file string defaults to "_".
  56.  
  57.       --_h_e_l_p
  58.            Print a summary of the options to xxxxaaaarrrrggggssss and exit.
  59.  
  60.       --_r_e_p_l_a_c_e[=_r_e_p_l_a_c_e-_s_t_r], -_i[_r_e_p_l_a_c_e-_s_t_r]
  61.  
  62.  
  63.  
  64.      Page 1                         (printed 5/18/98)
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.      XXXXAAAARRRRGGGGSSSS((((1111LLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXAAAARRRRGGGGSSSS((((1111LLLL))))
  72.  
  73.  
  74.  
  75.            Replace occurences of _r_e_p_l_a_c_e-_s_t_r in the    initial
  76.            arguments with names read from standard input.  Also,
  77.            unquoted    blanks do not terminate    arguments.  If
  78.            _r_e_p_l_a_c_e-_s_t_r is omitted, it defaults to "{}" (like for
  79.            `find -exec').  Implies -_x and -_l _1.
  80.  
  81.       --_m_a_x-_l_i_n_e_s[=_m_a_x-_l_i_n_e_s], -_l[_m_a_x-_l_i_n_e_s]
  82.            Use at most _m_a_x-_l_i_n_e_s nonblank input lines per command
  83.            line; _m_a_x-_l_i_n_e_s defaults    to 1 if    omitted.  Trailing
  84.            blanks cause an input line to be    logically continued on
  85.            the next    input line.  Implies -_x.
  86.  
  87.       --_m_a_x-_a_r_g_s=_m_a_x-_a_r_g_s, -_n _m_a_x-_a_r_g_s
  88.            Use at most _m_a_x-_a_r_g_s arguments per command line.     Fewer
  89.            than _m_a_x-_a_r_g_s arguments will be used if the size    (see
  90.            the -s option) is exceeded, unless the -x option    is
  91.            given, in which case xxxxaaaarrrrggggssss will exit.
  92.  
  93.       --_i_n_t_e_r_a_c_t_i_v_e, -_p
  94.            Prompt the user about whether to    run each command line
  95.            and read    a line from the    terminal.  Only    run the
  96.            command line if the response starts with    `y' or `Y'.
  97.            Implies -_t.
  98.  
  99.       --_n_o-_r_u_n-_i_f-_e_m_p_t_y, -_r
  100.            If the standard input does not contain any nonblanks,
  101.            do not run the command.    Normally, the command is run
  102.            once even if there is no    input.
  103.  
  104.       --_m_a_x-_c_h_a_r_s=_m_a_x-_c_h_a_r_s, -_s _m_a_x-_c_h_a_r_s
  105.            Use at most _m_a_x-_c_h_a_r_s characters    per command line,
  106.            including the command and initial arguments and the
  107.            terminating nulls at the    ends of    the argument strings.
  108.            The default is as large as possible, up to 20k
  109.            characters.
  110.  
  111.       --_v_e_r_b_o_s_e, -_t
  112.            Print the command line on the standard error output
  113.            before executing    it.
  114.  
  115.       --_v_e_r_s_i_o_n
  116.            Print the version number    of xxxxaaaarrrrggggssss and exit.
  117.  
  118.       --_e_x_i_t, -_x
  119.            Exit if the size    (see the -_s option) is exceeded.
  120.  
  121.       --_m_a_x-_p_r_o_c_s=_m_a_x-_p_r_o_c_s, -_P _m_a_x-_p_r_o_c_s
  122.            Run up to _m_a_x-_p_r_o_c_s processes at    a time;    the default is
  123.            1.  If _m_a_x-_p_r_o_c_s    is 0, xxxxaaaarrrrggggssss will run as    many processes
  124.            as possible at a    time.  Use the -_n option with -_P;
  125.            otherwise chances are that only one exec    will be    done.
  126.  
  127.  
  128.  
  129.  
  130.      Page 2                         (printed 5/18/98)
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.      XXXXAAAARRRRGGGGSSSS((((1111LLLL))))               UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV             XXXXAAAARRRRGGGGSSSS((((1111LLLL))))
  138.  
  139.  
  140.  
  141.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  142.       ffffiiiinnnndddd(1L), llllooooccccaaaatttteeee(1L),    llllooooccccaaaatttteeeeddddbbbb(5L), uuuuppppddddaaaatttteeeeddddbbbb(1) FFFFiiiinnnnddddiiiinnnngggg
  143.       FFFFiiiilllleeeessss    (on-line in Info, or printed)
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196.      Page 3                         (printed 5/18/98)
  197.  
  198.  
  199.  
  200.